Tutorial Integrasi Payment Gateway Tokuy ke BukaOLShop

Panduan lengkap untuk menghubungkan sistem pembayaran Tokuy ke aplikasi BukaOLShop Anda

Tingkat: Mudah
Diperbarui: 5 Juni 2025
1

Pengaturan Merchant di Dashboard Tokuy

Langkah pertama dalam integrasi adalah mengatur merchant Anda di dashboard Tokuy:

Dashboard Tokuy
Gambar 1: Menu Dashboard Tokuy
  1. Login ke akun Tokuy Anda
  2. Buka menu Pengaturan di sidebar
  3. Pilih submenu Merchant
Informasi Penting

Isi form dengan Nama Merchant (nama toko Anda) dan URL Website (alamat website BukaOLShop Anda). Pastikan URL yang dimasukkan sudah benar.

Perhatian!

Jika Sudah Menyimpan Nama Merchant Dan Url website, nanti pada Bagian Webhook URL tidak perlu diisi manual. URL ini akan terisi otomatis setelah Anda melakukan konfigurasi di bagian bukaolshop config.

2

Atur konfigurasi bukaolshop

Setelah menyimpan pengaturan merchant Tokuy, lanjutkan dengan konfigurasi di bukaolshop config:

Menu Konfigurasi BukaOLShop
Gambar 2: Menu Konfigurasi BukaOLShop
  1. Buka Menu Pengaturan Di sidebar Tokuy
  2. Pilih sub menu Bukaolshop Config
  3. Lengkapi semua field yang diperlukan:
    • URL Website BukaOLShop
    • Secret Key Bukaolshop Anda (dapatkan dari Aplikasi bukaolshop)
    • API Key Bukaolshop Anda (dapatkan dari Aplikasi Bukaolshop)
# Contoh format konfigurasi yang perlu diisi:
Website URL: https://toko-anda.bukaolshop.com
Secret Key: tky_xxxxxxxxxxxxxxxx
API Key: tky_yyyyyyyyyyyyyyyy
3

Mengatur URL Override

Setelah konfigurasi dasar selesai, langkah terakhir adalah mengatur URL override pada aplikasi bukaolshop anda:

URL Override di BukaOLShop
Gambar 3: Bagian URL Override
  1. Di halaman konfigurasi Tokuy di bagian bukaolshop config, cari bagian URL Override
  2. Copy URL yang ada di bagian QRIS_STD jika ingin menggunakan QRIS
  3. Paste URL tersebut ke form URL Topup/Halaman Transaksi di aplikasi BukaOLShop Anda
  4. Simpan semua perubahan
Integrasi Berhasil!

Anda telah berhasil mengkoneksikan Tokuy ke BukaOLShop. Lakukan testing transaksi untuk memverifikasi integrasi berfungsi dengan baik.

4

Testing Transaksi

Untuk memastikan integrasi berhasil, lakukan testing transaksi, berikut contoh halaman pembayaran Tokuy:

Proses Checkout BukaOLShop
Gambar 4: Proses Checkout dengan Tokuy di BukaOLShop
  1. Buka aplikasi BukaOLShop Anda sebagai customer
  2. Lakukan proses Deposit Di aplikasi anda seperti biasa
  3. Selesaikan transaksi test dengan nominal kecil
  4. Setelah pembayaran berhasil, akan otomatis terupdate
Troubleshooting

Jika transaksi test gagal:

  • Periksa kembali Secret Key dan API Key
  • Pastikan URL override sudah benar
  • Cek log error di dashboard Tokuy dan BukaOLShop
  • Hubungi support Tokuy jika masalah berlanjut